GetPlatformPrintJob

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODCanvas

GetPlatformPrintJob
The GetPlatformPrintJob method returns the print job for the specified graphics system for this canvas.
ODPlatformPrintJob GetPlatformPrintJob (
                                    in ODGraphicsSystem g);
g
A 16-bit value specifying the graphics system you want to use for this canvas. Valid graphics systems are platform dependent.
return value
A 32-bit value identifying the graphics-system-specific print job for this canvas. Before using the return value, you must cast it to a valid print job type (such as THPrint for QuickDraw or gxJob for QuickDraw GX).

DISCUSSION
On the Mac OS platform, the graphics system may be either QuickDraw (kODQuickDraw) or QuickDraw GX (kODQuickDrawGX).
If this canvas has a print job for the specified graphics system, this method returns that print job. On the Mac OS platform, the return value may be used to determine whether you are printing to a PostScript printer. You need to call this method only when you are creating a static canvas to use as a print job.
A canvas can have only one print job (for one graphics system) even if it has drawing structures for more than one graphics system.

EXCEPTIONS

kODErrInvalidGraphicsSystem
This implementation of OpenDoc does not support the specified graphics system, that graphics system is not installed or available, or this canvas does not have a print job for that graphics system.

SEE ALSO
The ODGraphicsSystem type (page 883).
The ODCanvas::HasPlatformPrintJob method (page 75).
The ODCanvas::SetPlatformPrintJob method (page 81).
"Issues for All Parts" on page 176 in OpenDoc Programmer's Guide.